home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmPanedWindow.z / XmPanedWindow
Text File  |  1998-10-30  |  35KB  |  529 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww - The PanedWindow widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/PanedW.h>
  13.  
  14.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  15.           This page documents Motif 2.1.
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           PanedWindow is a composite widget that lays out children in
  19.           a vertically tiled format. Children appear in top-to-bottom
  20.           fashion, with the first child inserted appearing at the top
  21.           of the PanedWindow and the last child inserted appearing at
  22.           the bottom. The PanedWindow grows to match the width of its
  23.           widest child and all other children are forced to this
  24.           width. The height of the PanedWindow is equal to the sum of
  25.           the heights of all its children, the spacing between them,
  26.           and the size of the top and bottom margins.
  27.  
  28.           The user can also adjust the size of the panes. To
  29.           facilitate this adjustment, a pane control sash is created
  30.           for most children. The sash appears as a square box
  31.           positioned on the bottom of the pane that it controls. The
  32.           user can adjust the size of a pane by using the mouse or
  33.           keyboard.
  34.  
  35.           The PanedWindow is also a constraint widget, which means
  36.           that it creates and manages a set of constraints for each
  37.           child. You can specify a minimum and maximum size for each
  38.           pane. The PanedWindow does not allow a pane to be resized
  39.           below its minimum size or beyond its maximum size. Also,
  40.           when the minimum size of a pane is equal to its maximum
  41.           size, no control sash is presented for that pane or for the
  42.           lowest pane.
  43.  
  44.           The default XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnn procedure for PanedWindow
  45.           causes all panes to appear first in the XXXXmmmmNNNNcccchhhhiiiillllddddrrrreeeennnn list and
  46.           all sashes to appear after the panes. For a pane child, it
  47.           returns the value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx if one has been
  48.           specified for the child. Otherwise, it returns the number of
  49.           _p_a_n_e_s in the PanedWindow's XXXXmmmmNNNNcccchhhhiiiillllddddrrrreeeennnn list. Other than the
  50.           fact that all sashes appear after all panes, the insertion
  51.           order of sashes is unspecified.  This procedure also causes
  52.           nonsash widgets to be inserted after other nonsash children
  53.           but before any sashes.  The behavior of PanedWindow is
  54.           undefined if XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnn is set to a procedure other
  55.           than the default.
  56.  
  57.           All panes and sashes in a PanedWindow must be tab groups.
  58.           When a pane is inserted as a child of the PanedWindow, if
  59.           the pane's XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is not XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP,
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           PanedWindow sets it to XXXXmmmmSSSSTTTTIIIICCCCKKKKYYYY____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP.
  75.  
  76.         DDDDeeeesssscccceeeennnnddddaaaannnnttttssss
  77.           PanedWindow automatically creates for each paned window the
  78.           descendants shown in the following table.  An application
  79.           can use XXXXttttNNNNaaaammmmeeee and the child list information to gain access
  80.           to the named descendant.  In addition, a user or an
  81.           application can use the named descendant when specifying
  82.           resource values.
  83.           NNNNaaaammmmeeeedddd DDDDeeeesssscccceeeennnnddddaaaannnntttt   CCCCllllaaaassssssss                     IIIIddddeeeennnnttttiiiittttyyyy
  84.           ______________________________________________________________________________________________________________________________________________________________
  85.           SSSSaaaasssshhhh               ssssuuuubbbbccccllllaaaassssssss ooooffff XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee   sash
  86.           SSSSeeeeppppaaaarrrraaaattttoooorrrr          XXXXmmmmSSSSeeeeppppaaaarrrraaaattttoooorrrrGGGGaaaaddddggggeeeetttt         dividing line between window panes
  87.  
  88.         CCCCllllaaaasssssssseeeessss
  89.           PanedWindow inherits behavior and resources from the CCCCoooorrrreeee,
  90.           CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr classes.
  91.  
  92.           The class pointer is _x_m_P_a_n_e_d_W_i_n_d_o_w_W_i_d_g_e_t_C_l_a_s_s.
  93.  
  94.           The class name is XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww.
  95.  
  96.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  97.           The following table defines a set of widget resources used
  98.           by the programmer to specify data. The programmer can also
  99.           set the resource values for the inherited classes to set
  100.           attributes for this widget. To reference a resource by name
  101.           or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  102.           prefix and use the remaining letters. To specify one of the
  103.           defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove
  104.           the XXXXmmmm prefix and use the remaining letters (in either
  105.           lowercase or uppercase, but include any underscores between
  106.           words).  The codes in the access column indicate if the
  107.           given resource can be set at creation time (C), set by using
  108.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  109.           not applicable (N/A).
  110.  
  111.                                      XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  112.           NNNNaaaammmmeeee                     CCCCllllaaaassssssss                TTTTyyyyppppeeee            DDDDeeeeffffaaaauuuulllltttt      AAAAcccccccceeeessssssss
  113.           XmNmarginHeight          XmCMarginHeight      Dimension       3            CSG
  114.           XmNmarginWidth           XmCMarginWidth       Dimension       3            CSG
  115.           XmNorientation           XmCOrientation       unsigned char   XmVERTICAL   CSG
  116.           XmNrefigureMode          XmCBoolean           Boolean         True         CSG
  117.           XmNsashHeight            XmCSashHeight        Dimension       10           CSG
  118.           XmNsashIndent            XmCSashIndent        Position        -10          CSG
  119.           XmNsashShadowThickness   XmCShadowThickness   Dimension       dynamic      CSG
  120.           XmNsashWidth             XmCSashWidth         Dimension       10           CSG
  121.           XmNseparatorOn           XmCSeparatorOn       Boolean         True         CSG
  122.           XmNspacing               XmCSpacing           Dimension       8            CSG
  123.  
  124.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt
  125.                     Specifies the distance between the top and bottom
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                     edges of the PanedWindow and its children.
  141.  
  142.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh
  143.                     Specifies the distance between the left and right
  144.                     edges of the PanedWindow and its children.
  145.  
  146.           XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn
  147.                     Specifies the layout as either vertical (with the
  148.                     XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLLvalue) or horizontal (with the
  149.                     XXXXmmmmHHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL value). In the vertical layout, the
  150.                     children are laid out in a vertically tiled
  151.                     format. In the horizontal layout, the children are
  152.                     laid out in a horizontal layout, with the sash
  153.                     moveable along the horizontal axis.
  154.  
  155.           XXXXmmmmNNNNrrrreeeeffffiiiigggguuuurrrreeeeMMMMooooddddeeee
  156.                     Determines whether the panes' positions are
  157.                     recomputed and repositioned when programmatic
  158.                     changes are being made to the PanedWindow.
  159.                     Setting this resource to True resets the children
  160.                     to their appropriate positions.
  161.  
  162.           XXXXmmmmNNNNssssaaaasssshhhhHHHHeeeeiiiigggghhhhtttt
  163.                     Specifies the height of the sash.
  164.  
  165.           XXXXmmmmNNNNssssaaaasssshhhhIIIInnnnddddeeeennnntttt
  166.                     Specifies the horizontal placement of the sash
  167.                     along each pane. A positive value causes the sash
  168.                     to be offset from the near (left) side of the
  169.                     PanedWindow, and a negative value causes the sash
  170.                     to be offset from the far (right) side of the
  171.                     PanedWindow. If the offset is greater than the
  172.                     width of the PanedWindow minus the width of the
  173.                     sash, the sash is placed flush against the near
  174.                     side of the PanedWindow.
  175.  
  176.                     Whether the placement actually corresponds to the
  177.                     left or right side of the PanedWindow depends on
  178.                     the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnnresource of the widget.
  179.  
  180.           XXXXmmmmNNNNssssaaaasssshhhhSSSShhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss
  181.                     Specifies the thickness of the shadows of the
  182.                     sashes.
  183.  
  184.           XXXXmmmmNNNNssssaaaasssshhhhWWWWiiiiddddtttthhhh
  185.                     Specifies the width of the sash.
  186.  
  187.           XXXXmmmmNNNNsssseeeeppppaaaarrrraaaattttoooorrrrOOOOnnnn
  188.                     Determines whether a separator is created between
  189.                     each of the panes.  Setting this resource to True
  190.                     creates a Separator at the midpoint between each
  191.                     of the panes.
  192.  
  193.  
  194.  
  195.      Page 3                                         (printed 10/24/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))
  203.  
  204.  
  205.  
  206.           XXXXmmmmNNNNssssppppaaaacccciiiinnnngggg
  207.                     Specifies the distance between each child pane.
  208.  
  209.  
  210.                                       XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  211.                    NNNNaaaammmmeeee               CCCCllllaaaassssssss              TTTTyyyyppppeeee        DDDDeeeeffffaaaauuuulllltttt           AAAAcccccccceeeessssssss
  212.                    XmNallowResize     XmCBoolean         Boolean     False             CSG
  213.                    XmNpaneMaximum     XmCPaneMaximum     Dimension   1000              CSG
  214.                    XmNpaneMinimum     XmCPaneMinimum     Dimension   1                 CSG
  215.                    XmNpositionIndex   XmCPositionIndex   short       XmLAST_POSITION   CSG
  216.                    XmNskipAdjust      XmCBoolean         Boolean     False             CSG
  217.  
  218.           XXXXmmmmNNNNaaaalllllllloooowwwwRRRReeeessssiiiizzzzeeee
  219.                     Allows an application to specify whether the
  220.                     PanedWindow should allow a pane to request to be
  221.                     resized. This flag has an effect only after the
  222.                     PanedWindow and its children have been realized.
  223.                     If this flag is set to True, the PanedWindow tries
  224.                     to honor requests to alter the height of the pane.
  225.                     If False, it always denies pane requests to
  226.                     resize.
  227.  
  228.           XXXXmmmmNNNNppppaaaannnneeeeMMMMaaaaxxxxiiiimmmmuuuummmm
  229.                     Allows an application to specify the maximum size
  230.                     to which a pane may be resized. This value must be
  231.                     greater than the specified minimum.
  232.  
  233.           XXXXmmmmNNNNppppaaaannnneeeeMMMMiiiinnnniiiimmmmuuuummmm
  234.                     Allows an application to specify the minimum size
  235.                     to which a pane may be resized. This value must be
  236.                     greater than 0 (zero).
  237.  
  238.           XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx
  239.                     Specifies the position of the widget in its
  240.                     parent's list of children (the list of pane
  241.                     children, not including sashes). The value is an
  242.                     integer that is no less than 0 (zero) and no
  243.                     greater than the number of children in the list at
  244.                     the time the value is specified. A value of 0
  245.                     means that the child is placed at the beginning of
  246.                     the list. The value can also be specified as
  247.                     XXXXmmmmLLLLAAAASSSSTTTT____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN (the default), which means that
  248.                     the child is placed at the end of the list. Any
  249.                     other value is ignored.  XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss returns the
  250.                     position of the widget in its parent's child list
  251.                     at the time of the call to XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss.
  252.  
  253.                     When a widget is inserted into its parent's child
  254.                     list, the positions of any existing children that
  255.                     are greater than or equal to the specified
  256.                     widget's XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxx are increased by 1.  The
  257.                     effect of a call to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss for
  258.  
  259.  
  260.  
  261.      Page 4                                         (printed 10/24/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                     XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnIIIInnnnddddeeeexxxxis to remove the specified widget
  273.                     from its parent's child list, decrease by one the
  274.                     positions of any existing children that are
  275.                     greater than the specified widget's former
  276.                     position in the list, and then insert the
  277.                     specified widget into its parent's child list as
  278.                     described in the preceding sentence.
  279.  
  280.           XXXXmmmmNNNNsssskkkkiiiippppAAAAddddjjjjuuuusssstttt
  281.                     When set to True, this Boolean resource allows an
  282.                     application to specify that the PanedWindow should
  283.                     not automatically resize this pane.
  284.  
  285.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  286.           PanedWindow inherits behavior and resources from the
  287.           superclasses described in the following tables.  For a
  288.           complete description of each resource, refer to the
  289.           reference page for that superclass.
  290.  
  291.                                                 XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  292.           NNNNaaaammmmeeee                      CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  293.           XmNbottomShadowColor      XmCBottomShadowColor    Pixel               dynamic                CSG
  294.           XmNbottomShadowPixmap     XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  295.           XmNforeground             XmCForeground           Pixel               dynamic                CSG
  296.           XmNhelpCallback           XmCCallback             XtCallbackList      NULL                   C
  297.           XmNhighlightColor         XmCHighlightColor       Pixel               dynamic                CSG
  298.           XmNhighlightPixmap        XmCHighlightPixmap      Pixmap              dynamic                CSG
  299.           XmNinitialFocus           XmCInitialFocus         Widget              NULL                   CSG
  300.           XmNlayoutDirection        XmCLayoutDirection      XmDirection         dynamic                CG
  301.           XmNnavigationType         XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  302.           XmNpopupHandlerCallback   XmCCallback             XtCallbackList      NULL                   C
  303.           XmNshadowThickness        XmCShadowThickness      Dimension           2                      CSG
  304.           XmNstringDirection        XmCStringDirection      XmStringDirection   dynamic                CG
  305.           XmNtopShadowColor         XmCTopShadowColor       Pixel               dynamic                CSG
  306.           XmNtopShadowPixmap        XmCTopShadowPixmap      Pixmap              dynamic                CSG
  307.           XmNtraversalOn            XmCTraversalOn          Boolean             True                   CSG
  308.           XmNunitType               XmCUnitType             unsigned char       dynamic                CSG
  309.           XmNuserData               XmCUserData             XtPointer           NULL                   CSG
  310.  
  311.                                                         CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  312.           NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  313.           XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  314.           XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  315.           XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  316.           XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  317.           XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  318.           XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  319.           XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  320.           XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  321.           XmNdepth                        XmCDepth                        int              dynamic                CG
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                         (printed 10/24/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))
  335.  
  336.  
  337.  
  338.           XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  339.           XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  340.           XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  341.           XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  342.           XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  343.           XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  344.           XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  345.           XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  346.           XmNx                            XmCPosition                     Position         0                      CSG
  347.           XmNy                            XmCPosition                     Position         0                      CSG
  348.  
  349.                                        CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  350.           NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt             AAAAcccccccceeeessssssss
  351.           XmNchildren         XmCReadOnly         WidgetList    NULL                G
  352.           XmNinsertPosition   XmCInsertPosition   XtOrderProc   default procedure   CSG
  353.           XmNnumChildren      XmCReadOnly         Cardinal      0                   G
  354.  
  355.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  356.           XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww inherits translations from XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr.
  357.  
  358.           The translations for sashes within the PanedWindow are
  359.           described in the following table.
  360.  
  361.           The following key names are listed in the X standard key
  362.           event translation table syntax.  This format is the one used
  363.           by Motif to specify the widget actions corresponding to a
  364.           given key.  A brief overview of the format is provided under
  365.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).  For a complete description of the
  366.           format, please refer to the X Toolkit Instrinsics
  367.           Documentation.
  368.  
  369.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
  370.                     SashAction(_S_t_a_r_t)
  371.  
  372.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111MMMMoooottttiiiioooonnnn>>>>:
  373.                     SashAction(_M_o_v_e)
  374.  
  375.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
  376.                     SashAction(_C_o_m_m_i_t)
  377.  
  378.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
  379.                     SashAction(_S_t_a_r_t)
  380.  
  381.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>:
  382.                     SashAction(_M_o_v_e)
  383.  
  384.           ~~~~cccc ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222UUUUpppp>>>>:
  385.                     SashAction(_C_o_m_m_i_t)
  386.  
  387.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>>:
  388.                     PrimitiveParentActivate()
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                         (printed 10/24/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))
  401.  
  402.  
  403.  
  404.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCaaaannnncccceeeellll>>>>:
  405.                     PrimitiveParentCancel()
  406.  
  407.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffHHHHeeeellllpppp>>>>:
  408.                     Help()
  409.  
  410.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
  411.                     SashAction(_K_e_y,_L_a_r_g_e_I_n_c_r,_U_p)
  412.  
  413.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
  414.                     SashAction(_K_e_y,_D_e_f_a_u_l_t_I_n_c_r,_U_p)
  415.  
  416.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
  417.                     SashAction(_K_e_y,_L_a_r_g_e_I_n_c_r,_R_i_g_h_t)
  418.  
  419.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
  420.                     SashAction(_K_e_y,_D_e_f_a_u_l_t_I_n_c_r,_R_i_g_h_t)
  421.  
  422.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
  423.                     SashAction(_K_e_y,_L_a_r_g_e_I_n_c_r,_D_o_w_n)
  424.  
  425.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
  426.                     SashAction(_K_e_y,_D_e_f_a_u_l_t_I_n_c_r,_D_o_w_n)
  427.  
  428.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
  429.                     SashAction(_K_e_y,_L_a_r_g_e_I_n_c_r,_L_e_f_t)
  430.  
  431.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
  432.                     SashAction(_K_e_y,_D_e_f_a_u_l_t_I_n_c_r,_L_e_f_t)
  433.  
  434.           ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn:
  435.                     PrimitiveParentActivate()
  436.  
  437.           ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
  438.                     PrevTabGroup()
  439.  
  440.           ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
  441.                     NextTabGroup()
  442.  
  443.         AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
  444.           The XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww action routines are
  445.  
  446.           Help():   Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any
  447.                     exist. If there are no help callbacks for this
  448.                     widget, this action calls the help callbacks for
  449.                     the nearest ancestor that has them.
  450.  
  451.           NextTabGroup():
  452.                     Moves the keyboard focus to the next tab group.
  453.                     By default, each pane and sash is a tab group.
  454.  
  455.           PrevTabGroup():
  456.  
  457.  
  458.  
  459.      Page 7                                         (printed 10/24/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww((((3333XXXX))))
  467.  
  468.  
  469.  
  470.                     Moves the keyboard focus to the previous tab
  471.                     group.  By default, each pane and sash is a tab
  472.                     group.
  473.  
  474.           SashAction(_a_c_t_i_o_n)))) or SashAction(_K_e_y,_i_n_c_r_e_m_e_n_t,,,,_d_i_r_e_c_t_i_o_n)))):
  475.                     The SSSSttttaaaarrrrtttt action activates the interactive
  476.                     placement of the pane's borders.  The MMMMoooovvvveeee action
  477.                     causes the sash to track the position of the
  478.                     pointer.  If one of the panes reaches its minimum
  479.                     or maximum size, adjustment continues with the
  480.                     next adjustable pane.  The CCCCoooommmmmmmmiiiitttt action ends sash
  481.                     motion.
  482.  
  483.                     When sash action is caused by a keyboard event,
  484.                     the sash with the keyboard focus is moved
  485.                     according to the _i_n_c_r_e_m_e_n_t and _d_i_r_e_c_t_i_o_nspecified.
  486.                     DDDDeeeeffffaaaauuuullllttttIIIInnnnccccrrrr adjusts the sash by one line.
  487.                     LLLLaaaarrrrggggeeeeIIIInnnnccccrrrr adjusts the sash by one view region. The
  488.                     _d_i_r_e_c_t_i_o_nis specified as either UUUUpppp, DDDDoooowwwwnnnn, LLLLeeeefffftttt, or
  489.                     RRRRiiiigggghhhhtttt.
  490.  
  491.                     Note that the SashAction action routine is not a
  492.                     direct action routine of the XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww,,,, but
  493.                     rather an action of the Sash control created by
  494.                     the XXXXmmmmPPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww.
  495.  
  496.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  497.           This widget has the following additional behavior:
  498.  
  499.           <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
  500.                     Moves the keyboard focus to the sash and
  501.                     highlights it
  502.  
  503.           <<<<FFFFooooccccuuuussssOOOOuuuutttt>>>>:
  504.                     Unsets the keyboard focus in the sash and
  505.                     unhighlights it
  506.  
  507.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  508.           The bindings for virtual keys are vendor specific.  For
  509.           information about bindings for virtual buttons and keys, see
  510.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).
  511.  
  512.      RRRREEEELLLLAAAATTTTEEEEDDDD
  513.           CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3), CCCCoooorrrreeee(3),
  514.           XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPaaaannnneeeeddddWWWWiiiinnnnddddoooowwww(3), and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3).
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                                         (printed 10/24/98)
  526.  
  527.  
  528.  
  529.